Welcome to CityTime version 5.7.7
Released May 10, 2005
Contents..
Introduction
What's New in this Version
Installation
Getting Started
Useful Tips for Using the Program
Special Features: Zoom
Special Features: DST
Special Features: Accompanying Programs
Special Features: Color CityTime
Registering CityTime
Contact Details
Introduction
CityTime is an advanced world clock which shows an accurate and easy to use day/night plot on the screen. The plot adjusts throughout the day as the earth rotates, and changes shape with the seasons as the earth tilts north and south relative to the sun.
The program includes a self installing database of default cities and these are fully customizable allowing for the display of the current time in any city in the world. A large collection of additional cities can also be imported from data files provided online - please see our website for more information.
CityTime also has advanced time utility functions such as the Time Calculator, the ability to work out sunrise and sunset times for cities throughout the world and a unique Change Location option which allows you to adjust the Palms date and time automatically when traveling between cities.
As with all our previous upgrades, this is a free update to CityTime.
What's New in this Version
This version, version 5.7.7 includes a fix for a problem where the city database could be reset when upgrading to version 5.5.5. Otherwise this version is operationally the same as the last release.
-Version 5.7.5 was released in April 2005
The major change in version 5.7.5 over previous versions is that the program is now "Treo Safe" and should not conflict with earlier releases of CityTime, especially the 'ROM' or 'Factory Installed' versions of CityTime which are installed on all Treo devices as well as on all previous Handspring products.
On the surface there may not appear to be much that has changed in this version, however to allow the program to operate safely with factory installed versions we have had to move to a new Creator Code for CityTime and support the transferring of the various preference and database files that the program requires.
Also, CityTime Alarms has been updated to version 1.1 (it's included with this download) so that it can recognize CityTime and it's data files. This newer version of CityTime alarms should work reliably with both this and older versions of CityTime. Previous versions of CityTime Alarms will only work with versions of CityTime using the old creator code.
The result of all this is that, should you have a device with a ROM based version of CityTime installed, you should be able to run both programs reliably and without any conflicts between them.
-Version 5.7, released in March 2005 includes a new Dialling Codes Screen which lists International dialling codes as well as U.S. and Canandian codes. 'Dialling Codes' appears as a new option at the bottom of the Utilities Menu within the program.
-Version 5.6, released in September 2004 inluded the Currency program (which used to be a seperate program) within CityTime itself. 'Currency' is a new option on the Utilities menu within the program and includes all of the features of the previously separate 'CityTime Currency' program.
-Version 5.5, released in June 2004 primarily added support for large screen devices such as the T3 and other third party large screen products. The program allows for the main screen map to be scaled and zoomed in any orientation and additionally provides a new eight city view when the main screen map is zoomed out in tall mode.
-Version 5.0, released in February 2004 included major updates and a new zoom function. Please see the Zoom section of this document for more information.
Installation
CityTime has been designed so that it is easy to install and update. There are no installation or setup programs required either to install or upgrade CityTime. The default database is automatically created when the program is first run or if the database is deleted. This automatic database creation facility also allows CityTime to be beamed to other devices.
The file is normally transferred over the Internet as a compressed '.zip' file and should be decompressed automatically by most web browsers. The decompressed file required to either install or upgrade the program is called 'CityTime.prc'. To enable the zoom features install either the 'CTLoDMaps.pdb' file for normal density OS 4 color devices or the 'CTHiDMaps.pdb' file for high density OS 5 and later devices.
- New Installation: The required files can be installed by choosing 'Install Handheld Files' from the Palm Desktop program or the HotSync Manager program. The file can also be dragged and dropped onto either of these programs. The file will be installed on the device during the next HotSync.
- Existing Installation. The program is updated in the same way as it is originally installed. All versions of CityTime can be installed over the top of any existing version. All database and registration information will be automatically updated if required from previous versions. There is no need to delete any files before upgrading this product.
If you are having problems installing the program, please see the support section at our web site (www.codecity.net) for more detailed information, or write to us at the email addresses below.
Getting Started
The operation of CityTime should be fairly straightforward. Detailed help text is provided to explain every area of the program and can be accessed either by tapping on the (i) button in any dialog, or by choosing 'Help' from the menu on the main screen.
The first thing to do is to ensure that your home city is set correctly so that the day night plot and remote city times will be accurate. When the program is first run it will ask you to select your current home city. If you cannot find a suitable city, choose one that's nearby, or at least in the same time zone. You can always return to this screen later after setting up your home city by choosing 'Select Home City' from the Options menu.
If required you can then go to the Edit Cities area and create, duplicate or import any new cities as required.
The best way to check that the home city is set correctly is by checking that the edge of the day/night plot passes over your home city when the sun is rising or setting outside.
Note: The latitude and longitude of a city do not affect the positioning or accuracy of the day night plot (contrary to expectations). The day/night plot is based on your time zone and the current time and date only. You do not have to enter the exact coordinates of your current location, or even be close, to have the day night plot and world times display accurately.
Useful Tips for Using the Program
- To make city selection faster when a list of cities is displayed, write the first letter of the city in the Graffiti area to show cities beginning with that letter. For example, to find London quickly, write an 'L' in the Graffiti area when any list of cities is displayed.
- Use the hardware up and down buttons to make navigating through the lists of cities easier. This is easier and much faster than tapping the on screen up and down arrows
- Use the hardware up and down buttons to control the zoom functions when viewing the main screen. The up button controls the zoom and the down button switches the mode when zoomed in.
- Tapping on the home city name and time (in the top right corner of the screen) will show the current day and date in your home city for a few seconds.
- Tapping anywhere on the map will show the time, day of week and the current DST state in the nearest City.
- Star shaped indicators will appear throughout the program to indicate that a city is currently in Daylight Saving Time. Cities can have either manual or automatic DST settings and all of the default (and import) cities which use DST will update their DST state automatically throughout the year. Further information can be found in the help areas in the Edit Cities screens within the program.
- While becoming familiar with reading the day / night plot keep in mind that the plot always moves gradually from right to left (as the earth rotates towards the East). For example, if the dark area of the plot is just to the left of a city, this means that the sun has recently risen in that area. With practice you can get a good estimate of the time anywhere in the world just by referring to the day/night plot.
- Throughout the program (everywhere except the main screen), additional help can be found by clicking on the (i) icon in the top right corner of any window. Main Screen help is available from the 'Help' menu option.
- The day/night plot changes shape throughout the year as the rotation axis of the Earth changes relative to the Sun. Twice a year (at the equinoxes near the end of September and March) the plot will be perfectly square for a day or two as the whole earth experiences almost equal amounts of day and night. (Please don't send a bug report - we get lots of bug reports every six months when the plot is no longer curved!). The plot will change shape and move gradually north or south each day between these times.
Special Features: Zoom
This version of CityTime supports zooming into or out of the main screen map when an appropriate map file is installed on the device. If CityTime is installed without the map files then it will operate without the ability to zoom into the main screen map but will otherwise operate as it did in previous versions. If you have not seen the zoom functions running then we strongly recommend that you install the map files as it greatly increases the appearance and utility of this program.
Your device must be a color device and be running at least Palm OS 4.0 for the zoom mode to operate. The original Palm IIIc unfortunately will not run in zoom mode due to the color depth of it's display - all other Color Palm devices are capable of running in zoom mode.
The two map files included with this download are 'CTLoDMaps.pdb' and 'CTHiDMaps.pdb'. The Lo Density maps are for OS 4 devices and the Hi Density maps are for double density OS 5 and above devices. Both files can be installed without harm and the program will automatically select the appropriate map file.
The map files can be installed either into main memory or onto an expansion card. Launching of the program is quickest when installed into main memory - otherwise the map files will be temporarily copied into main memory when the program launches and then deleted when the program closes down. Copying the maps into main memory may take a second or two and the copying is indicated at program startup.
If the map files are installed on a memory card they must be placed in one of the following two locations;
/Palm/Launcher/
/CityTime/
These directory names are case insensitive. If the map files are placed elsewhere on the card they will not be found. Note that if you simply install the map files via the desktop Hotsync program to the card then they will end up in the /Palm/Launcher/ directory automatically.
If you would like to manipulate or move the files on a card then a utility program such as FileMan or Filez will be required.
The very basic instructions for using the zoom mode is that the 'up' hardware button switches between zoomed in mode and zoomed out mode and the 'down' hardware button switches between the Locate and Move modes. Further instructions are provided within the program on by selecting Zoom Instructions from the Zoom menu.
The Zoom Status option, also available from the Zoom menu indicates the status of the zoom mode including if the map files are installed and if the device is capable of running in zoom mode.
Please note that without the map files the program will operate as before on all Palm devices running Palm OS 2 or above - and will display to the best of the devices abilities even on black and white devices.
Special Features: DST
The following is information about the automatic Daylight Savings Time implementation in CityTime.
General
- The changeover time for switching into and out of DST is calculated in local time for each city. On the days when a city either moves into or out of DST, the time will change at 2:00am in the cities non DST time. When switching into DST, at 2:00am the time will change to 3:00am. When switching out of DST, at 2:00am the time will change to 1:00am
- The default button in the Edit Cities area allows you to restore a city's Automatic DST and other settings for pre installed cities.
Specific Country Information
- New Zealand. New Zealand goes out of DST on the first Sunday in March on or after the 15th. This also happens to be the third Sunday in March for at least the next ten years, probably forever.
- Brazil. As for New Zealand, the first Sunday in February on/after the 15th is also the third Sunday for at least the next ten years, probably forever.
- Israel. The start and end of DST is set politically in Israel so that it fits in with religious events. The dates in future years may be different ot the dates set by default in the program
- Three or four (mostly Middle Eastern) countries go into and out of DST on specific days of the month. This is not supported in the current version of CityTime and the changeover days have been set so they will always be within a couple of days of this by default.
Further information about setting and using the automatic DST features is available from the help areas within the program.
Special Features: Accompanying Programs
CityTime Alarms is included with this download package but is a separate program and must be registered seperately.
Please see the Read Me files accompanying Citytime Alarms for instructions about it's use.
Special Features: Color CityTime
Since early 2000, CityTime has shipped in two versions, a color version and the original black and white version. With the release of version 5.0 and later we are including the color version only in the download package. The previous black and white version was Citytime 4.0 and is almost identical to this version when running on a black and white device. If you are interested in the black and white version of CityTime please write to us via the contact information below.
Registering CityTime
CityTime can be easily registered online via the 'Products' link on the front page of our web site at;
http://www.codecity.net
If you register via the codecity site you will receive a registration key via email immediately.
If you would prefer to register by mail, phone, fax etc., please get in touch with the people at any of the following sites. They are all resellers of Code City products;
PalmGear: http://www.palmgear.com
Handango: http://www.handango.com
Phone, fax and address details should be on the front page or easily accessible from each of these sites. Registered users get as much support and help with the product as they like and will automatically receive information about important updates to the program. (We have not and will not sell our registered users list and do not pass on any email addresses).
Contact Details
Web Site:
http://www.codecity.net
Email:
Support2@codecity.net